home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 2000 August: Tool Chest / Dev.CD Aug 00 TC Disk 2.toast / pc / sample code / human interface toolbox / htmlsample / aboutbox.h < prev    next >
Encoding:
C/C++ Source or Header  |  2000-06-23  |  2.4 KB  |  81 lines
  1. /*
  2.     file AboutBox.h
  3.     
  4.     Description:
  5.     This file contains the routine prototypes for calls defined in AboutBox.c
  6.     These routines are used to manage the about box window displayed when
  7.     the user chooses 'About HTMLSample...' from the file menu.
  8.     
  9.     HTMLSample is an application illustrating how to use the new
  10.     HTMLRenderingLib services found in Mac OS 9. HTMLRenderingLib
  11.     is Apple's light-weight HTML rendering engine capable of
  12.     displaying HTML files.
  13.  
  14.     by John Montbriand, 1999.
  15.  
  16.     Copyright: © 1999 by Apple Computer, Inc.
  17.     all rights reserved.
  18.     
  19.     Disclaimer:
  20.     You may incorporate this sample code into your applications without
  21.     restriction, though the sample code has been provided "AS IS" and the
  22.     responsibility for its operation is 100% yours.  However, what you are
  23.     not permitted to do is to redistribute the source as "DSC Sample Code"
  24.     after having made changes. If you're going to re-distribute the source,
  25.     we require that you make it clear in the source that the code was
  26.     descended from Apple Sample Code, but that you've made changes.
  27.     
  28.     Change History (most recent first):
  29.     10/16/99 created by John Montbriand
  30. */
  31.  
  32.  
  33. #ifndef __ABOUTBOX__
  34. #define __ABOUTBOX__
  35.  
  36. #include <Types.h>
  37. #include <Windows.h>
  38.  
  39.  
  40. /* OpenAboutBox opens the about box window and returns
  41.     a pointer to the window in *aboutBox.  There can only
  42.     be one about box open at a time, so if the about box is
  43.     already open, then this routine brings it to the front
  44.     by calling SelectWindow before returning a pointer to
  45.     it. */
  46. OSStatus OpenAboutBox(WindowPtr *aboutBox);
  47.  
  48.  
  49. /* EnsureAboutBoxIsClosed closes the about box window
  50.     if it is open.  If it is not open then this routine does
  51.     nothing. */
  52. void EnsureAboutBoxIsClosed(void);
  53.  
  54.  
  55. /* AboutBoxUpdate should be called for update events
  56.     directed at the about box window.  It calls
  57.     BeginUpdate and EndUpdate and does all of the
  58.     drawing required to refresh the about box window. */
  59. void AboutBoxUpdate(WindowPtr aboutBox);
  60.  
  61.  
  62. /* AboutBoxActivate should be called for activate events
  63.     directed at the about box window. */
  64. void AboutBoxActivate(WindowPtr aboutBox, Boolean activate);
  65.  
  66.  
  67. /* AboutBoxCloseWindow closes the about box window. 
  68.     this routine deallocates any structures allocated
  69.     by the OpenAboutBox. */
  70. void AboutBoxCloseWindow(WindowPtr aboutBox);
  71.  
  72.  
  73. /* IsAboutBox returns true if the window pointer
  74.     in the aboutBox parameter is not NULL and
  75.     points to the about box. */
  76. Boolean IsAboutBox(WindowPtr aboutBox);
  77.  
  78.  
  79. #endif
  80.  
  81.